Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / TELESHAR.ZIP;1 / DOCHELP@.EXE / TSDIAL.DOC < prev next >

Wrap

Text File | 1993-07-21 | 12.0 KB | 312 lines

TeleShare DOS REMOTE ACCESS TSDIAL Page 1 _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| Member TeleShare/DIAL the TeleShare dialer program ============================================== TSDIAL is the the Telephone dialer that comes with TeleShare. TSdial's simple script language and command line switches, will do a good job for most TeleShare users. TSDIAL is designed to minimally and momentarily intrude into DOS memory space while it does its job, then quickly quit leaving other software to continue. TSDIAL is shareware. If you are not familiar with shareware please read the SHR_WARE.DOC and the REGISTER.DOC distributed with TeleShare. Command line switches: First, if you just enter the dialer's name or add a -H it will display its Help or usage screen, which provides the information repeated below. Dialing: TSdial [-Fyourfile -D433-5189 -T -W -H] -F for the File switch. The manual lists WAIT, BEEP, etc. commands. You can put commands in the specified file for the dialer to follow. -D for the Dialing switch. Command line dialing only uses the TSCONFIG.CFG file. -T for the Terminal switch. -W to Wait for a phone call. -H for this help. The -F file switch uses a text file of instructions that will normally include a range of simple script commands. It is the most general purpose switch. The script commands will be provided after the command line switches. The -D Dial a number switch is useful for simply dialing a number or hanging up and the like. For example, for hanging up you can use "TSDIAL -DATH0". The dialer automatically reads in the general teleshare setup file and uses it to write TeleShare DOS REMOTE ACCESS TSDIAL Page 2 to the correct communications port. The -T Terminal switch sets up the dialer as a minimal terminal, most useful for learning, testing, and diagnostic activities. Use the ESCape key to step through the terminal. The -W Wait for a call switch simply sets the dialer up to wait for an incoming call. It normally will then wait up to about 23 hours (to zero minutes in the same hour in the next day). You may add a D, as in -TD or -WD, for the demonstration setup. The -F and -D switches cannot use the D because it might conflict with a filename or dialing instructions, so you may add a secondary -D as in "-Fscript_file -D". See the DEMONSTRATION command below. The simple script commands: They are shown below just like they might be used. Its a good idea to check out the included sample files. If you miss-spell a script command, that line is sent to the modem as is. This feature is designed to allow you to send any string to your modem. Some of the commands are "modem specific" and will be listed first below. These commands should also be placed first or early in the file so the dialer can setup the modem before processing the rest of the file. You cannot 'reset' the dialer by sending them later. Modem Specific commands: NAME its_name Your description for the modem. The dialer uses this for its internal database. INIT The modem initialization string. The initialization string sets the modem up for reliable communications. FAIL The modem fail strings. The dialer uses word fail commands, such as "BUSY" instead of numbers so you can easily understand them. COMPRESS The modem compression string, if any. Compression strings are used by modems as they negotiate a setup for a particular communications session. If both modems have similar compression capability they can setup much faster effective data transfers for you. DEMONSTRATION To allow the dialer to continue operating even when its setup routines fail to gain control of the specified TeleShare DOS REMOTE ACCESS TSDIAL Page 3 communications port. This allows you to practise or test drive without a modem or COM port setup. PROTOCOL The modem protocol string, if any. Protocol strings are like a form of compression string, in that modems can negotiate a common protocol for enhanced behaviour during a communications session. INITBAUD The initial modem baud rate. Note that 'INIT BAUD' could be mistaken as 'INIT' by the dialer, so avoid using it. LOCKBAUD 1 to lock the baud rate, or 0 to avoid locking. Locked baud rates are used with higher performance communications sessions. HANDSHAKE 1 for handshaking or 0 for no handshaking. ENDMODEM The switch or signal for the final modem command in the setup file so the dialer does not have to search the entire file for setup commands. It speeds up processing to tell the dialer where to stop hunting. Other Dialer commands: # This # symbol is used for comments in the file. Put the # at the far left column to tell the dialer to ignore the rest of the line. This symbol follows standard M4 or Make script language. You will notice that these comments are echoed to the screen when ECHO is ON. ABORT To tell the dialer to immediately quit leaving the machine and the communications settings unchanged. This allows other communications software to take over and continue a session. BEEP 5. To beep five times. You can tell the dialer to beep from 1 to 99 times. BLOCK To block or stop strings that are not recognised as modem commands from being sent to the modem. CLEAR To simply clear the screen. DIAL some_thing. To dial a number or whatever follows it on the same line. See also REDIAL below. ECHO To display a single line when ECHO is off. ECHO ON To switch display of the script commands on ECHO OFF or off. Useful for script reviews/debugging, especially when used with DEMONSTRATION. HANGUP To send the modem a hangup command. You could also TeleShare DOS REMOTE ACCESS TSDIAL Page 4 just send a command string like "ATH0", but with this command the dialer checks and reminds wonky modems when necessary. LOGFILE some_file_name To instruct the dialer to echo or repeat the script commands into the disk file specified on the same line. It opens and appends to the bottom of existing files. PULSE To tell the dialer to change from TONE to PULSE dialing. The dialer defaults to tone. QUIT To shut down gracefully after closing the communications session . REDIAL 5. To tell the dialer to redial 5 times when it is given a DIAL command. You can set it to any value between 1 and 99 times. (Go ahead and try something like 934 times if you like). Put the REDIAL command above the target DIAL command in the script file. WAIT 12:00 To tell the dialer to wait until a specified time in 24 hour format. If you do not include a time, it will wait indefinitely, like a non-TSR screen saver. WAITFORCALL To wait up to about 23 hours for a call. The dialer normally uses the previous hour as the target time unless otherwise instructed. Note that "WAIT FOR CALL" will be interpreted as a WAIT command. WAITFORCALL 22:35 To wait until the given time for a call. WAITFORSTRING HI THERE To wait for a specific string to be send 'from the other end' once a connection has been made. The string will be case insensitively compared to incoming strings for three times the carrier timeout (normally 180 seconds), then will quit as an error. Any other text strings found in the script file are simply sent to the modem/port, just in case you have a use for such an occurrence. Passwords might be one example. Support and the ASP Please consider reporting the circumstances, preferably in written form, to technical support when you discover problems with the software. For technical support, either call (604) 433-5189, or write to Suite 606 - 6455 Willingdon Avenue, Burnaby, British Columbia, Canada, V5H 4E4. Both registered and soon to be registered users currently get the same support without any arbitrary time limit. You may also try leaving a Compuserve message at TeleShare DOS REMOTE ACCESS TSDIAL Page 5 75020, 2664, but be aware that messages rapidly 'scroll off' Compuserve. The best electronic message area (also available from Compuserve) is via the internet at: INTERNET:vic_williams@mindlink.bc.ca. P. C. Softsmith Suite 606 6455 Willingdon Ave Burnaby, B. C., Canada V5H 4E4 ASP Introduction: Please also carefully read the accompanying SHR_WARE.DOC document. "This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536." This document and associated TeleShare documents and software are Copyright (C)1993 P. C. Softsmith All Rights Reserved. THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING ITS MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE. THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE AND DOES NOT REPRESENT A COMMITTMENT ON THE PART OF THE VENDOR. OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR REGISTERED TRADEMARKS OF THEIR RESPECTIVE HOLDERS.